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ABSTRACT 


This  technical  note  describes  a  data  acquisition  system  developed  at  DREO 
for  the  measurements  of  very  fast  transient  electromagnetic  fields  generated 
during  ENP  testing.  The  system  consists  of  several  high  speed  transient 
digitizers,  all  connected  to  a  personal  computer.  It  has  the  capability  to 
simultaneously  record  on  several  channels  the  response  of  single-shot  events. 
The  overall  system  is  controlled  by  a  master  program  called  DAQ.  DAQ  can  control 
a  number  of  digitizers  simultaneously,  allowing  automation  of  part  of  the 
measurement  process.  The  data  transferred  to  the  PC  is  automatically  bound  with 
related  information  such  as:  experiment  description,  setup  information  (sensor, 
cable,  attenuator,  and  instrument  used),  digitizer  parameters,  and  data 
processing.  DAQ  can  archive  and  retrieve  the  results  of  a  large  number  of 
experiments.  DAQ  can  produce  plots  of  the  results  on  the  screen  or  on  hardcopy, 
and  also  has  the  capability  to  Import  the  plots  into  popular  word  processors  for 
the  preparation  of  reports.  DAQ  Incorporates  several  digital  signal  processing 
routines,  which  may  be  used  to  process  the  raw  data.  Various  implementations  of 
Finite  Impulse  Response  (FIR)  and  Infinite  Impulse  Response  (HR)  filters  are 
supported,  as  well  as  some  of  the  classical  approaches  such  as  Butterworth 
low-pass  and  hi-pass  filters. 
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Cette  note  technique  ddcrit  un  systdme  d' acquisition  de  donn6es  d6velopp6 
au  CRDO  pour  permettre  les  mesures  de  champ  61ectromagn6tique  extrSmement  rapide 
qui  sent  gdnArds  lors  des  test  d'lEN.  Le  systAme  comprends  plusieurs  numdriseurs 
trAs  rapides  reliAs  A  un  ordinateur  personnel,  permettant  de  contrOler  plusieurs 
canatix  simultanAment  et  de  permettre  une  certaine  automatisation  des  opArations. 
Toutes  les  donnAes  obtenues  des  instruments  sont  combinAes  avec  d’autres 
informations,  telles  que:  une  description  de  1 ' expArience ,  une  description  de 
1 ' arrangement  des  capteurs,  cables,  attAnuateurs  et  instruments  utilisAs,  les 
paramAtres  des  instruments,  ainsl  qu'une  description  des  traitements  numAriques 
A  effectuAs.  Le  systAme  permet  de  gArer  sur  disque  une  large  collection 
d'expArlences.  II  peut  aussi  afflcher  les  rAsultats  sous  forme  graphique  A 
I'Acran  ou  sur  papier,  ou  encore  sous  forme  compatible  avec  plusieurs  logiciels 
de  traltement  de  texte.  Le  systAme  permet  de  dAfinir  des  f litres  numAriques  FIR 
ou  HR,  de  mAme  que  les  approches  classiques  des  filtres  passe-bas  ou  passe-haut, 
telles  que  les  filtres  Butterworth. 


EXECUTIVE  SUMMARY 


DREO  has  built  a  large  experimental  facility  for  the  measurement  of  the 
effects  of  nuclear  electromagnetic  pulse  (EMP)  on  systems.  The  transient  field 
generated  is  extremely  short  and  difficult  to  measure.  This  technical  note 
describes  the  data  acquisition  system  designed  to  collect  and  archive  these 
measurements . 

The  system  consists  of  several  high  speed  transient  digitizers,  all 
connected  to  a  personal  computer  through  an  IEEE-488  instnanentation  bus.  It  has 
the  capability  to  simultaneously  record  on  several  channels  the  response  of 
single-shot  events.  The  overall  system  is  controlled  by  a  master  program 
developed  at  DREO.  This  program,  called  DAQ,  runs  in  an  Interactive  environment, 
allowing  one  to  easily  manipulate  the  data  and  create  new  routines. 

DAQ  has  the  capability  of  controlling  a  number  of  digitizers 
simultaneously,  allowing  one  to  automate  part  of  the  measurement  process.  As  the 
data  is  transferred  to  the  PC,  it  is  automatically  bound  with  related  information 
such  as:  experiment  description,  setup  information  (sensor,  cable,  attenuator, 
and  Instrument  used),  digitizer  parameters,  and  data  processing.  The  system  is 
designed  to  easily  archive  and  retrieve  the  results  of  a  large  ntunber  of 
experiments.  DAQ  can  produce  plots  of  the  results  on  the  screen  or  on  hardcopy, 
and  also  has  the  capability  to  import  them  into  popular  word  processors  for  the 
preparation  of  reports. 

DAQ  has  an  extensive  set  of  built-in  digital  signal  processing  routines, 
which  are  used  to  enhance  signals,  compensate  for  errors,  recover  the  transfer 
functions  of  sensors  and  cables,  or  simply  for  data  analysis.  Various 
implementations  of  FIR  and  HR  filters  are  supported,  as  well  as  some  of  the 
classical  approaches  such  as  Butterworth  low-pass  and  hi -pass  filters. 
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1.0  IMTRODUCTION 


This  technical  note  describes  a  data  acquisition  system  designed  at  DREO 
for  the  measurement  of  very  fast  transients.  It  is  part  of  the  DREO  EMP 
(electromagnetic  pulse)  testing  facility  used  for  studying  the  EMP  phenomena  and 
verifying  the  hardening  of  equipments.  These  transients  are  produced  by  high- 
voltage  generators  suddenly  discharging  into  a  transmission  line.  The  field 
generated  is  of  the  order  of  50  kV  per  meter,  with  a  rise  time  of  about  5  nsec. 
This  field  Induces  currents  and  voltages  in  the  object  under  test.  Fields, 
currents  or  voltages  are  measured  with  the  use  of  appropriate  sensors  connected 
to  fast  digitizers.  A  personal  computer  (PC)  is  used  to  control  the  digitizers 
and  to  read  and  process  the  data. 


1 . 1  INSTROMENTATION 

Several  digitizers  are  used  to  provide  a  multi-channel  capability.  They 
all  feature  a  very  fast  single-shot  sampling  rate  and  a  wide  vertical  amplifier 
bandwidth.  They  are  all  fully  programmable  through  an  IEEE-488  interface  and  can 
be  operated  in  stand-alone  mode  (ie.  without  a  computer).  In  the  current 
configuration,  up  to  5  simultaneous  channels  are  available.  The  table  below 
lists  the  key  characteristics  of  the  instruments  (G- s/sec  stands  for  'Giga- 
samplas  per  second' ) . 


Qty 

Model 

#  of 
channels 

Bandwidth 

Sampling  rate 

1 

SCDIOOO 

1 

1  (3Iz 

200  G*  s/sec 

2 

TEK7912HB 

1 

700  MHz 

100  G*  s/sec 

1 

DSA602 

2 

400  MHz 

2  G*  s/sec  -  1  channel 

1  G*  s/sec  -  2  channels 

1.2  SYSTEM  DESCRIPTION 

All  the  digitizers  are  connected  to  a  computer  through  the  use  of  a  single 
IEEE-488  bus  (also  called  a  HPIB  or  GFIB  bus).  Although  most  of  their  functions 
ere  prograimsable ,  most  adjustments  are  made  in  local  mode  from  the  front  panel 
and  the  coBq>uter  will  only  control  a  few  functions. 

The  computer  is  a  286-  or  386-based  personal  computer  with  at  least 
640  Kbyte  of  memory  and  a  math  co-processor.  It  is  preferable  however  to  use  a 
386-computer  with  more  than  2  Mbyte  of  memory.  The  current  implementation  uses 
a  33  MHz  386-computer  with  a  80387  co-processor.  8  MByte  of  memory.  150  MByte 
hard-disk  and  a  VGA  adapter  and  monitor.  The  system  is  complemented  with  a 
HP  LaserJet  Series  II  laser  printer  and  a  HP  7550  pen  plotter.  The  laser  printer 
can  also  emulate  a  HPGL  plotter  with  a  special  cartridge  (HPGL”*  Emulation,  from 
Pacific  Data  Products). 

All  the  software  for  the  control  of  the  Instruments  and  for  the  analysis 
of  the  data  is  designed  for  the  ASYST  environment.  ASYST  is  an  integrated 
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software  designed  for  instrument  interfacing  via  IEEE-488,  RS-232,  A/D,  D/A  and 
digital  I/O  interfaces.  It  provides  a  full  range  of  scientific  analysis  and 
programming  capabilities.  It  can  execute  commands  interactively  or  can  load 
compiled  programs. 

The  package  developed  at  DREO  is  called  DAQ,  for  Data  AcQuisition.  It  runs 
under  ASYST.  It  integrates  instrumentation  control,  data  transfer,  data 
management  and  plotting  capabilities. 


1 . 3  SYSTEM  CONFIGURATION 

ASYST  is  memory-hungry,  particularly  in  the  first  640  KByte  (the  famous  DOS 
640K  barrier),  and  thus  must  be  configured  carefully  to  minimized  the  amount  of 
conventional  memory  (ie.  below  640K)  required.  It  is  asstimed  throughout  this 
document  that  the  reader  is  familiar  with  DOS  and  ASYST. 


1.3.1  CONFIGURING  DOS 

To  free-up  as  much  conventional  memory  as  possible  and  also  to  provide 
expanded  memory  support,  a  memory  manager  such  as  QEMM  should  be  used.  It  allows 
one  to  load  resident  programs  in  high  memory  (ie.  between  640K  and  IMEG)  thus 
freeing  memory.  It  fully  Implements  the  EMS  4  expanded  memory  specifications. 
It  may  also  be  necessary  to  increase  the  number  of  file  buffers  and  the 
environment  size.  A  typical  'CONFIG.SYS'  file  would  be: 

BUFFERS-24, 1/X 
FZLES-30 
FCBS-8,2 
LASTDRIVE-Z 

SHELL«C:\COMMAND.COM  /E:600  /P 
STACK-0,0 

DEVlCE«C:\gEMM\QEMM386  RAM  options... 

DEVICE«C:\gEMM\LOADHI.SYS  /B  MOUSE. SYS 
DEVICE-C:\gEMM\LOAOHl.SYS  /B  C:\DOS\ANSI.SYS 

where  the  3  first  lines  increase  the  size  of  various  DOS  buffers.  Note  that  the 
'FILE-'  and  'FOBS-'  options  can  be  done  with  some  QENN  utilities  in  the 
'AUTOEXEC.BAT'  file,  freeing  a  little  more  memory.  The  'LASTDRIVE-'  option  must 
define  at  least  drive  g:  (V:  if  the  PC-NFS  network  is  used).  The  'SHELL'  option 
Increases  the  size  of  the  environment.  The  'STACK-'  option  removes  all  stack 
support  (this  capability  is  almost  never  used  by  DOS  applications).  The  first 
'DEVICE-'  option  loads  the  memory  manager  and  subsequent  ones  are  used  with 
'LOAOHI.SYS'  to  load  programs  and  drivers  in  high  memory. 

If  a  RAM  disk  (virtual  disk)  is  defined.  DAQ  will  automatically  use  it  for 
temporary  storage  and  will  also  copy  its  own  overlays  to  it  for  faster  execution. 
An  empty  file  named  'CtX-RAMDISK.d'  must  be  created,  where  'd'  is  the  drive 
letter. 
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The  ASYST  environment  is  initialized  during  the  'AUTOEXEC.BAT'  execution. 
The  following  lines  should  be  placed  in  it; 

CALL  d:\ASYST\SET-UP  * 

SUBST  Q:  d:\ASYST 

%diere  'd:'  is  the  drive  where  ASYST  resides. 


1.3.2  CONFIGURIHG  ASYST 

Configuring  ASYST  consists  of  loading  few  system  overlays  permanently, 
defining  the  size  of  various  buffers  and  arrays,  loading  a  common  user  library, 
and  saving  the  result  in  a  file  (named  'CNF>LIB').  The  procedure  described  below 
is  done  only  when  installing  a  new  version  of  ASYST,  installing  it  on  a  different 
machine,  or  when  the  library  is  updated. 

To  configure  ASYST: 

Change  directory  to  Q:\V3-10  (tdiere  the  original  ASYST  resides) 

Start  ASYST  and  enter  the  configuration  mode  ('<F2>'  key) 

Specify  the  hardware  configuration: 

386  processor 
25  MHz  speed 
VGA  graphics 
HP  LaserJet  printer 

Load  the  following  overlays  permanently: 

Data  file 
HP  plotter 
GPIB  master 
GPIB  drivers  type -2 

Setup  the  GPIB  options  (select  bus  #0): 

Board  type>10  (lOtech  GP488  board) 

ME  address  ~  0 
I/O  address  -  2E1 


Interrupt  ••  7  (not  tised  in 

this  version  of  DAQ) 

Set  the  memory  configuration: 

Symbol  table  size: 

24  Kbytes 

String  segment  size; 

8  Kbytes 

DAS  buffer  size: 

0  Kbytes 

GPIB  queue  size: 

0  Kbytes 

User  dictionary  size: 

42  Kbytes 

Token  heap  size: 

48  Kbytes 

Unnamed  array  (heap)  size: 

48  Kbytes 

Keyboard  buffer  size: 

300  bytes 

System  buffer  size 

16384  bytes 
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Not*  that  th*  aystaa  buffer  will  b*  too  small,  but  will  b* 
dynamically  incraasad  and  moved  to  expanded  memory  during 
execution. 

Us*  th*  command  ’LOAD  \USBRS\LlBRARy\CNF.300'  to  load  the  user 
library. 

Enter  th*  memory  configuration  again  and  minimized  the  system 
(specify  file  name  'CNF-LIB'). 

Reload  the  file  'CNF-LIB'  and  save  with  *$SAVE'  (specify  'CNF-LIB' 
for  output) . 


1.4  LOADING  THE  DAQ  SOFTWARE 

Th*  DAQ  software  is  located  into  th*  '\USXRS\DAQ'  subdirectory.  It  also 
uses  some  programs  found  in  a  library  in  th*  subdirectory  '\USERS\LIBRARy' .  DAQ 
uses  the  ASYST  concept  of  applications  overlays.  These  are  compiled  versions  of 
programs  which  can  be  loaded  only  when  necessary.  They  need  to  be  recompiled 
only  idien  on*  of  th*  programs  is  modified.  The  loading  procedure  described  below 
autoutleally  checks  if  all  th*  overlays  are  valid. 

FOROKT.ALL 
CHDIR  \USBRS\DAQ 
LOAD  .\DAQ. 

It  may  take  few  minutes  to  load  all  of  th*  programs.  It  is  also  possible  to  save 
th*  executable  image  after  loading  all  of  th*  programs  with  th*  '$SAVB'  command. 
When  ASYST  is  loaded  by  invoking  this  new  file,  it  is  not  necessary  to  us*  the 
loading  procedure  above. 


This  loading  procedure  may  fail  if 
following  commands  are  used  to  recompile 


some  Invalid  overlays  are  found, 
all  overlays: 


The 


FOROKT.ALL 
CHDIR  \USKRS\DAQ 
CRXATl. OVERLAY  DFXLTXRS.MKO 
CRXATK. OVERLAY  FILB.MKO 
CREATE. OVERLAY  PLOT.NKO 
LOAD  .\DAQ.1 

CREATE. OVERLAY  DAQ-KDZT.NKO 
CREATE. OVERLAY  DAQ-FILE.MXO 
CREATE. OVERLAY  DAQ-PLOT.MKO 
CREATE. OVERLAY  SCOPE. MXO 
LOAD  .\DAQ.2 


which  may  be  followed  by  a  '$SAVB'  command 


1.5  MULTI-TASKING  WITH  DESQVIXW 


ASYST  has  bean  successfully  run  under  th*  DESQview  multi-tasking 
environment.  DESQview  is  a  windowing  aystui  that  allows  execution  of  several 
applications  simultaneously.  Th*  distributed  version  of  ASYST  is  too  big  to  fit 
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in  a  DESQvlaw  window  and  tha  ainlaizad  version  described  in  the  Section  1.3.2 
■ust  be  used.  It  is  also  inportant  that  any  aeaory  resident  programs  or  drivers 
bo  loaded  above  640K;  the  use  of  a  memory  manager  such  as  QEMN386  is  thus 
essential . 
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2.0  DATA  ACQUISITION  PACKAGE 


This  data  acquisition  software,  called  DAQ,  was  developed  at  DREO  for  the 
acquisition  and  processing  of  very  fast  transients  encountered  during  EMP 
testing.  It  has  the  capability  to  control  the  instrument at ion,  to  perform  data 
transfer,  to  execute  various  digital  signal  processing  algorithms,  to  maintain 
a  data  base  of  measurements,  and  to  provide  on-screen  and  hardcopy  plotting. 

Upon  loading  (as  described  in  Section  1.4),  most  of  the  DAQ  operation  is 
interactive  idiile  some  other  functions  can  be  invoked  in  a  command  line  or 
included  in  a  user  program.  The  interactive  functions  are  accessible  through  the 
function  keys  ’<F5>'  to  ’<F10>'.  The  commands  ‘DAQ.FKEYS.ON'  and  ’ D AQ . FKEYS . OFF ' 
are  used  to  enable  and  disable  the  function  keys  operation. 

Most  of  the  DAQ  functions  can  be  divided  in  three  different  classes: 

•  instrumentation  control  and  data  transfer 

•  measurement  data  management.  Including  digital  signal  processing 

•  plotting  of  measurements,  on  screen  or  hardcopy 


2 . 1  INSTRUMENTATION  CONTROL 

Although  all  the  digitizers  listed  in  Section  1.1  can  be  fully  operated 
from  either  their  front  panel  or  through  a  IEEE-488  bus,  it  was  chosen  that  all 
of  the  Instrument  setup  and  adjustment  (vertical  gain  and  coupling,  horizontal 
sweep  control,  trigger,  etc.)  would  be  done  from  the  front  panel.  This  approach 
has  the  obvious  advantage  of  reducing  the  software  required  (and  a  lot  of 
programmer's  time),  but  also  it  makes  it  easier  to  adjust  the  instrument  because 
of  better  feedback  with  the  operator.  It  also  keeps  the  capability  to  use  some 
of  the  advanced  features  available  on  some  instruments  (eg.  the  DSA602  has  the 
capability  to  perform  local  data  processing). 

The  only  functions  which  are  controlled  by  the  computer,  through  the 
IEEE-488  bus,  are: 

•  Reset  of  the  instrument 

•  Arm  the  Instrument  for  a  single  sweep  acquisition 

•  Transfer  of  data  acquired  by  the  instnunent  to  the  computer 

•  Digitize  the  ground  reference  (some  digitizers  only) 

•  Digitize  graticule  defects  (some  digitizers  only) 


The  software  controlling  the  Instruments  uses  the  'device  drivers'  concept. 
With  this  approach,  the  procedure  to  request  a  particular  action  or  data  from  an 
instrument  is  the  same  for  every  instrument  and  thus  the  application  program  need 
not  know  about  the  syntax  and  protocols  particular  to  each  instniment. 
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In  this  version  of  DAQ,  the  various  functions  are  implemented  in: 

•  File  'SCOPE. ASY'  —  Standard  calls  to  perform  actions;  the 

appropriate  device  driver  is  then  called. 

•  Files  'TEKIOOO',  'TEK7912 .ASY'  and  *TEK602.ASY‘  —  These  are  the 
device  drivers  for  the  SCDIOOO,  7912HB  and  DSA602  respectively. 

•  File  'DAQ.ASY'  —  This  is  the  application  program,  which  in  this  case 
maps  the  various  operations  to  the  function  keys. 


2.2  MEASUREMENT  DATA  MANAGEMENT 

During  an  experiment,  each  event  (single  shot)  is  recorded  on  one  or  more 
channels,  and  the  experiment  may  be  repeated  many  times,  after  possibly  modifying 
some  of  the  setup  such  as  moving  to  the  next  test  point.  After  the  data  has  been 
transferred  from  the  digitizers,  it  is  usually  displayed  to  check  the  accuracy 
of  the  measurement  and  may  also  be  processed.  It  is  most  likely  to  be  stored  on 
disk  for  later  retrieval  and  analysis.  When  the  data  is  recorded,  it  is  very 
important  to  retain  information  which  will  describe  as  fully  as  possible  the 
setup  and  equipment  used  during  the  experiment.  In  addition  to  the  raw  data  (a 
sequence  of  points,  in  volts,  at  equally  spaced  intervals),  additional 
Information  should  include:  the  time  step  and  possible  a  time  offset,  the 
vertical  scale  and  offset,  the  date  and  time  of  the  experiment,  a  title,  a 
description  of  the  setup  (eg.  sensor  and  cable  used).  It  is  important  that  all 
the  information  relevant  to  a  measurement  done  on  one  channel  remains  together 
when  manipulated  or  stored  on  disk.  To  address  that  problem,  two  concepts  were 
introduced:  'structures'  and  'waveforms',  which  will  be  discussed  in  more  detail 
later  in  this  section.  Structures  allow  multiple  objects  to  be  packed  into  a 
single  array.  Waveforms  define  how  a  structure  is  partitioned  to  store  all  the 
information  relevant  to  a  measurement. 


2.2.1  STRUCTURES 

A  structure  is  defined  as  a  collection  of  one  or  more  variables,  possibly 
of  different  types  and  varying  size,  grouped  together  in  a  single  array.  This 
concept  is  similar  to  what  many  high-level  computer  languages  define  as 
structures  or  records.  There  is  however  one  major  difference:  the  type  and  size 
of  a  variables  to  be  stored  in  a  structure  is  defined  dynamically. 

Structures  are  Implemented  using  single  precision  integer  arrays.  They  are 
created  with  an  user-specified  number  of  items,  which  are  initially  empty. 
Scalar,  single -dimensioned  arrays  or  character  strings  can  be  stored  in  an  item. 
Niimeric  values  may  be  single  precision  Integers  or  single  precision  reals  (double 
precision  or  complex  values  are  not  currently  allowed) .  Items  can  be  extracted 
or  replaced;  new  items  can  be  added  and  some  may  be  deleted. 

The  internal  definition  of  a  structure,  shown  below,  contains  a  header,  a 
list  of  pointers  (one  set  of  pointers  for  each  item)  and  the  content  of  each 
item.  Each  pair  of  brackets  (”[  ]”)  represent  one  single  precision  word. 
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Header  area: 

2-b3rte  string  (value  32123) .  identi¬ 
fying  the  array  as  a  structure 

available  to  the  user  to  identify 
the  content  of  the  structure 

available  to  the  user 

#  of  Iteas  in  the  structure 

Pointers  area  (one  set  for  each  item) : 
[beg]  [end]  [type]  'beg*  and  'end'  are  index  within 

_  ...  ...  this  array  pointing  the  data  area 

of  this  item 

'type'  refers  to  the  data  stored: 

1-Integer,  3-Real.  9-Strlng 
All  zero  if  item  is  empty. 

Data  area: 

[data]  [data]  . . .  [data]  data  of  1*^  non-empty  item 

[data]  [data]  [data]  . . .  [data]  data  of  next  non-empty  item 


["(>"] 

[user-id] 

[user-option] 
[#  of  items] 


The  header  and  pointers  area  are  always  present  while  the  data  area  is 
dynamically  adjusted  as  data  is  stored  or  deleted.  All  data  is  converted  to 
single  precision  integers  before  being  stored  and  are  reconstructed  when  it  is 
extracted.  Single  precision  reals  are  mapped  as  two  integers  (4  bytes)  and 
strings  are  packed  as  two  characters  in  an  integer.  It  should  be  noted  that 
because  a  structure  varies  .dynamically  in  length,  it  cannot  be  stored  in  a 
named- array,  and  thus  tokens  must  be  used.  Tokens  have  the  additional  advantage 
of  using  expanded  memory  for  storage. 


2.2.2  WAVEFORMS 


A  waveform  is  a  structure  containing  all  the  information  pertinent  to  one 
measurement.  The  information  is  obtained  from  the  digitizers,  the  setup,  the 
user,  or  is  generated  by  DAQ.  A  example  of  a  waveform  is  shown  here; 


Comment t^This  is  a  sample  waveform 
Tr.  Oesct  LI  on  MAIN  Tiaw  step: 

Label:  377  Ohm  Time  offset: 

Date:  91/08/29  16:03:37  User  offset: 
Data:  512  pts  Att.(dB): 

Process:  1  itesis  Sensor  scale: 


1.9570B-10 

O.OOOOB-1 

2.0033B-2 

3.0000R1 

2.2599K11 


Ch:  4 
Shot:  0 
Sensor : 
Cable: 
Scope: 


V. scale 
V.  offset 


0  11944 

0  0 
1000  16089 


where  the  source  and  description  of  each  field  is: 
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from  digitizers; 

time  step  (or  AT)  Tine  in  second  between  data  points, 

vertical  scale  and  offset  Raw  data  is  (y+offset)- scale, 

raw  data  An  array  of  up  to  2048  data  points 

(integer  or  real). 

trace  description  Some  digitizers  such  as  the  DSA602 

have  the  option  of  defining 
traces . 


fron  the  setup 

DAQ  channel  #  8  channels  are  defined,  6  are 

currently  used. 

digitizer  on  this  channel  Digitizer  used:  model  #  and  id.  (or 

asset  #), 

cable  used  Cable  used:  model  #  and  id. 

sensor  used  Sensor  used:  model  #  and  id.  (or 

asset  #) . 

sensor  scaling  factor  Factor  to  convert  volts  to  field 

intensities  or  other  quantities. 
Sum  of  all  attenuators  used. 


To  Identify  the  experiment. 

Short  title  to  identify  a  particular 
option.  Will  be  included  in 
hardcopy  plots. 

A  #  given  to  this  measurement. 

For  aligning  multiple  waveforms 
(such  as  a  trigger  offset). 

An  additional  offset  (in  Volt)  added 
to  the  raw  data. 

List  of  operations  (signal 

processing)  to  performed  on  the 
raw  data. 


Date  and  time  of  the  data 
acquisition. 

The  inforMtion  from  the  setup  and  the  user  may  be  entered  into  a  'default 
waveform' .  which  is  autoutlcally  used  when  creating  a  new  waveform  idien  reading 
the  data  from  the  digitizers. 

All  the  fields  defined  above  are  amalgamated  together  into  a  single  array 
as  a  structure.  The  internal  definition  of  a  waveform  is  shown  below.  Brackets 
(”[  ]”)  denote  indexing  of  an  array. 


attenuation 

from  the  user 

comment  or  title 
label 


shot  # 
time  offset 

user  offset 

data  processing 


from  DAQ 

date  and  time 


Structure  header: 

[1]  String  "{)"  (value  32123) 

[2]  String  *VF”  (value  18007) 

[3]  •102,  identifies  version  1.02 

[4]  >7,  #  of  items  in  waveform. 
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.  Item  1 


Item  2 


[1] 

[21  &  [3] 
[4]  &  [5] 
[61  &  [7] 
[8] 


Item  3 
[11 
[21 
[31 
[4] 
[51 
[6] 
[71 


Item  4 


Item  5 


Item  6 


Item  7 


Character  string.  The  comment,  trace 
description  and  label  field  are 
packed  into  it. 

Integer  parameters  (must  all  be 
present ) 

Channel  # 

Sensor  type  and  id. 

Cable  type  and  id. 

Digitizer  type  and  id.  (asset  #) 

Shot  # 

Real  parameters  (must  all  be  present) 
Time  step  (AT),  origin  0. 

Vertical  scale  factor  (0  if  none) 
Vertical  offset  (0  if  none) 

Time  offset  (0  if  none) 

Sensor  scaling  factor  (0  if  none) 
Attenuation,  in  dB  (0  if  none) 

User  offset 

Date  &  time,  packed  into  a  DIM[3]  array 

May  contain  a  structure  representing  a 
list  of  data  processing  operations  to 
be  performed. 

Raw  data,  usually  an  integer  array. 

When  extracted,  It  is  modified  by 
vertical  scale  and  offset. 

Processed  data.  This  item  stores  the 
resulting  processed  data  array,  it  is 
not  usually  stored  in  files  as  it  can 
be  easily  calculated  again. 


Only  items  2  and  3  mat  be  present  at  all  times.  Other  items  are  created 
only  when  necessary. 

The  version  number  identifies  the  version  used  when  creating  a  waveform. 

Whenever  a  waveform  recalled  from  file  is  from  a  previous  version,  it  is 
automatically  converted  to  the  current  (latest)  version. 

Item  1  is  the  concatenation  of  all  fields  defined  as  strings.  It  has  the 
following  format:  « 

"maln_tltle_fiold\TRA:trace_deecripitlon_field\LAB:label— field” 

where  the  main  title,  if  present,  is  first,  and  additional  fields,  if  any,  follow 
(in  no  particular  order)  using  the  syntax  ”\XXXt string”  where  *XXX:'  represent 
a  user-defined  header. 
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VAien  th«  raw  data  la  axtractad  from  a  waveform,  it  is  modified  only  by  the 
vertical  scale  and  offset,  yielding  to  a  quantity  in  Volt: 

where  {x}  is  the  array  (usually  an  integer  array)  transferred  from  the  digitizer. 
Similarly,  the  processed  data  array  is  calculated  as: 

{yp>  -  (  (yr«J  ♦  User„fj„t )  •  Sensor,e.i,  *  10A*^tn/20 

followed  by  the  operations  listed  in  the  data  processing  list. 


2.2.3  DATA  PROCESSING  LISTS 


The  data  processing  to  be  performed  on  a  waveform  is  also  stored  along  with 
it  in  item  5.  If  present,  this  field  contains  a  structure  representing  a  list 
of  operations  to  perform,  one  operation  per  item.  Each  item  consists  of  an 
integer  or  real  array  (possibly  only  one  element) .  where  the  first  element  is  a 
cods  representing  the  operation.  The  format  for  the  items  of  a  processing  list 
is  shown  below.  Brackets  ("[  ]”)  denote  indexing  of  the  item. 


(11-01 

-02 

-03 

—08 


(2] 

[3] 

[4..nl 
[n4>l.  .m] 


Scale  by  [2] 

Offset  by  [2] 

Scale  by  1/(2] 

Integrate  (use  AT).  Also  scale  by  [2]  if 
present . 

Integrate  offset  for  end  value- [2] 

General  FIR  filter. 

Valid  for  AT-[2]  (0-valid  for  all  AT) 
Coefficients 

General  FIR  filter. 

Coefficients  are  stored  in  file.  File  name 
packed  in  [2..n] 

General  HR  filter  —  h(z)^(z)/a(z) 

Valid  for  AT-[2]  (0-valid  for  all  AT) 
size  of  a(z) 

Coefficients  a(z) 

Coefficients  b(z) 


-21 

(2..nl 


General  HR  filter. 

Coefficients  are  stored  in  file.  File  name 
packed  in  [2..n] 
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General  HR  filter,  cascaded  form. 

Valid  for  AT-[2]  (0-valid  for  all  AT) 
Coefficients  (Hx6  array)  stored  in  a  vector 

!■*  order  low-pass  filter.  H(s)-l/(s/uc+l) ,  fc 
(in  Hz)  stored  in  [2] 

Inverse  of  a  1*^  order  hi -pass  filter. 
H(s)-(s/ec+l)/(»/»e) .  fe  (in  Hz)  stored  in  [2] 

Filter  performing  a  partial  integrator  recovery 
(see  reference  [1]),  H(s)«>(s/»e+l)/s ,  f^  (in  Hz) 
stored  in  [2] 

N^-order  Butterworth  low-pass  filter,  N  stored 
in  [1]  and  f^  (in  Hz)  stored  in  [3] 

-41  !•*  order  hi -pass  filter,  H(s)-(s/ttc)/(s/«e+i) . 

fe  (in  Hz)  stored  in  [2] 

-42  Inverse  of  a  1*^  low-pass  filter,  H(s)-s/ue-i’l ,  fc 

(in  Hz)  stored  in  [2] 

-45  N*^-order  Butterworth  hi -pass  filter,  N  stored  in 

[1]  and  fc  (in  Hz)  stored  in  [3] 


-22 

-31 

-32 

-33 


[2] 

[3..] 


-35 


A  process  item  can  be  disabled,  but  kept  in  the  list,  by  storing  the 
negative  of  the  code  in  [1]. 

Conversion  from  the  Laplace  transform  to  the  z-transform  is  performed  by 
using  the  bl-linear  transformation  (Refersnce  [2]): 


s 


2  1-z-i 

■XT  TTPI 


2.2.4  DATA  FILES 

DAQ  makes  use  of  data  files,  as  defined  by  ASYST.  They  consist  of  a  number 
of  comment  lines  followed  by  numerical  data  stored  in  'subfiles'.  The  main 
limitation  with  ASYST  data  file  system  is  that  once  a  subfile  is  defined,  its 
size  and  structure  cannot  be  changed.  As  the  data  stored  in  waveforms  vary  in 
size,  a  new  file  structure,  using  ASYST  data  files,  was  defined.  It  is  somewhat 
similar  to  the  structure  of  a  disk:  subfiles,  like  blocks  on  a  disk,  all  have 
the  same  size.  The  data  is  stored  into  one  or  more  subfiles  (blocks),  not 
necessarily  consecutive,  and  pointers  are  use  to  maintain  a  linked-list. 

DAQ  data  files  can  store  \ip  to  100  waveforms  which  can  be  randomly 
accessed,  ie.  numbered  from  1  to  100.  A  block  size  of  600  is  used  (the  number 
of  data  points  from  digitizers  is  often  a  multiple  of  512,  and  adding  the 
additional  information  to  store  in  a  waveform  makes  them  usually  a  little  less 
than  a  multiple  of  600).  However,  DAQ  will  correctly  read  data  files  with 
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dlfferant  block  sizes.  The  structure  of  DAQ  data  files  is  as  follow:  4  comment 
lines,  3  index  arrays,  and  1  to  999  data  blocks;  all  arrays  are  single  precision 
integers : 


Comment# 

1  Header  «  "{DAQ}  VARRAY  -  Struct  &  wfm  on  disk" 

2  reserved 

3  Title  or  user  comment 

4  Available  to  user 


Subfile# 

1  {size}  DIM[100]  array,  size  of  the  waveform  stored. 

2  {1st}  DIM[100j  array,  pointer  to  the  first  data  block. 

3  {idx}  DIM[999]  array,  pointer  to  the  next  data  block. 

Set  to  -1  if  this  is  the  last  block  of  data.  Set  to  0  if 
the  block  is  unused. 

4-1002  Data  area.  Data  block  #1  correspond  to  subfile  #4. 


This  structure  will  accommodate  files  as  large  as  1  MBytes  (about  500,000 
data  points) .  However  DAQ  can  be  easily  reconfigured  to  accommodate  larger  files 
(see  file  ’OAQ-VARR.ASY' ) . 


2.3  PLOTTING  HATEFORMS 

DAQ  has  the  capability  of  plotting  up  to  20  waveforms  simultaneously. 
Every  time  a  waveform  is  added  to  the  plot,  some  information  (x  and  y  arrays, 
minimum  and  maximum  values,  and  the  label  field)  is  stored  in  a  trace  file 
( *DAQ{PLT}.TNP' )  which  is  used  to  either  refresh  the  plot  on  screen  or  to  create 
a  hardcopy  plot.  Originally,  hardcopy  plots  were  made  on  a  HP  pen  plotter  such 
as  a  HP  7550.  It  is  now  possible  to  use  a  HP  LaserJet  to  produce  black  &  white 
plots.  This  is  possible  by  using  a  special  cartridge  (HPGL™  Emulation,  from 
Pacific  Data  Products)  which  eonilates  the  HPGL  plotter  language.  It  is  also 
possible  to  send  a  hardcopy  plot  to  one  or  more  files.  These  files  can  be 
Imported  directly  in  WordPerfect  or  DrawPerfect  to  Include  in  reports. 

DAQ  does  not  use  the  ASYST  primitive  functions  'XY. AUTO. PLOT'  and 
*XY. DATA. PLOT'  but  instead  it  uses  the  new  functions  'XY.PLOT' ,  'XY.DPLOT'  and 
few  others  (found  in  the  file  'PLOT. LIB')  which  produce  better  results.  Other 
functions  fotind  in  'PLOTTER. UTL'  implement  plotter  redirection  and  utilities. 
Refer  to  Section  4.8  for  a  description  of  the  plotting  routines. 
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3.0  nrrgRACTivE  fpmctioms 


The  interactive  fiinctions  are  acceaaible  through  the  function  keys  '<F5>' 
to  '<F10>' .  The  function  keys  '<F1>'  to  *<F4>'  retain  their  definition  as 
defined  by  the  'LINE. EDIT'  conunand.  The  function  keys  *<F11>'  and  '<F12>'  are 
reserved  for  future  use.  The  coomands  'DAQ.FKEYS.ON'  and  'DAQ.FKEYS.OFF'  are 
used  to  enable  and  disable  the  function  keys  operation.  The  template  below  shows 
the  assignment  of  each  key; 


Ooerbue 

WlIRrlllNnW 

fEs 

at 

Show 

Ch.M«c. 

WfmMao. 

Copyy 

m 

Ch.  (Miuiis 

Ch.ClMr 

VMtnEdtt 

Copyafy 

am 

Ptottar 

Stieot 

Ch.  Arm 

Ch.RMd 

Copywfm 

Plot 

IFE 

F8 

Ft 

iiiiiiiii 

F10 

'DAQ.FKEYS.ON'  will  in  turn  call  'OAQ.INIT',  irtiich  will  initialize  all 
arrays  and  parameters  if  not  done  already.  A  GPIB  bus  reset  will  also  be 
performed.  Either  'DAQ.FKEYS.ON'  or  'DAQ.INIT'  must  be  called  at  least  once 
before  using  any  of  the  DAQ  functions  ('DAQ.INIT'  could  be  called  if  the 
interactive  functions  are  not  necessary) . 

If  a  RAM  disk  is  available  (see  Section  1.3.1)  the  commands  'RAM. DISK. ON' 
and  'RAM. DISK. OFF'  can  be  used  to  enable  or  disable  its  use  by  DAQ.  Vfhen  used, 
the  DAQ  application  overlays  and  all  temporary  files  are  copied  to  it  and 
executed  from  there. 

Most  functions,  when  activated  by  pressing  one  of  the  ftmction  keys,  also 
prompt  the  user  for  additional  input.  This  is  in  the  form  of  a  single  letter, 
a  number,  a  list  of  numbers,  or  a  string.  All  Inputs,  except  for  the  single 
letter  input,  are  terminated  with  '<CR>'.  Vhen  the  user  is  asked  for  a  single 
letter  input,  the  prompt  highlights  the  possible  choices  for  the  answer.  If  'F' 
is  one  of  the  choices,  a  single  digit  number  may  also  be  typed  (the  allowed  range 
is  defined  by  the  context).  In  some  cases,  some  hidden  choices  are  available: 
they  are  usually  shortcuts  to  specify  an  arguaent.  In  general,  if  '  channel'  is 
one  of  the  choices,  typing  a  single  digit  (1-8)  will  select  that  channel. 
Pressing  '<CR>'  only  usually  specifies  a  default  action.  In  this  report,  the 
hi^li^t  is  shown  as  a  underline  and  the  default  action  as  a  double  underline. 
At  any  time,  the  '<KSO'  key  can  be  used  to  cancel  the  current  operation, 
returning  to  the  ASTST  prompt  or  one  of  the  previous  prompts. 

DAQ  assumes  that  it  is  located  on  drive  Q:  (see  Section  1.3.1  for  proper 
configuration)  in  the  directories  'Q:\USERS\DAQ'  and  'Q:\USRRS\LIBRARY'. 
Temporary  files  are  also  stored  initially  in  'Q:\USKRS\DAQ'.  To  display  the 
current  location  of  various  items,  the  'SHOW  logicals'  function,  invoked  with  the 
'Alt/F5'  key  produce  the  following  listing  (without  the  comments  on  the  right); 
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OAQ: 

Q: \USERS\DAQ\ 

The  DAQ  program  files 

LIB: 

Q: \USBRS\LIBRARY\ 

The  library  files 

SOV: 

EJ\ASYST\V3-10\ 

The  ASYST  program  and  overlays 

AOV: 

Q: \USERS\DAQ\ 

The  DAQ  overlays 

TMP: 

Q: \USERS\DAQ\ 

Temporary  files 

3 . 1  INSTRUMENTATION  CONTROL 


There  are  in  the  preaent  configuration  6  instrumentation  channels  (or 
traces)  defined.  Note  that  this  correspond  to  only  5  real  inputs  to  the 
digitizers;  instruments  like  the  DSA602  allow  to  define  more  traces  than  the 
actual  number  of  inputs. 

The  'SHOW  6PIB'  function,  invoked  with  the  *Alt/F5'  key  produces  the 
following  listing: 


Ch  # 
1 
2 
3 

4-6 


Type  #tr  6P1B  ad. 


TEK7912  1  3 

TEK7912  1  4 

SCDIOOO  1  6 

DSA602  3  5 


which  shows  the  model  of  digitizer,  the  number  of  channels  (traces)  for  each,  and 
the  GFIB  address. 


The  template  below  shows  which  function  keys  are  used  to  control  the 
instruments : 


ChMfbes 

WIm  MMaure 

m 

CM 

Show 

Wfm  Mse. 

Copyy 

Ml 

Ch.defsuNi 

WtmEdtt 

CopyxAy 

SNR 

rnnSm 

SsiMt 

ChAim 

Copy  wfm 

Plol 

fS 

FB 

F7 

FS 

F9 

F10 

3.1.1  RESET  6PIB  BUS  (Ctl/F6) 

This  function,  which  does  not  take  ai^  argument,  performs  a  reset  of  the 
GPIB  bus.  It  is  autoMtically  called  by  the  'DAQ. PREYS. ON*  and  'DAQ.lNlT* 
functions. 


3.1.2  SELECT  (F5) 

All  the  functions  interfacing  with  the  instrumentation  can  be  performed  on 
a  single  channel  or  on  multiple  channels.  When  an  operation  applies  to  oiultiple 
channels,  it  uses  a  previously  stored  selection.  This  command  is  used  to  store 
the  selection.  At  the  "Select  channels t  "  prompt,  simply  enter  the  selection, 
each  entry  separated  by  a  space. 


IS 


The  'CLEAR' ,  'ARM' ,  'READ'  and  'MISC.  FUNCTIONS'  functions  prompt  the  user 
to  select  single  or  multiple  channels  for  the  operation.  The  prompt  for  the 
channel  selection  is  always  in  the  form: 

"...select  single  or  all  selected  channels:  ” 

where  answering  'single'  brings  the  additional  prompt  "channel  #:  "  and  typing 
'all'  or  '<CR>'  recalls  the  previously  stored  selection.  It  is  also  possible  to 
use  a  shortcut  to  specify  a  single  channel  by  typing  a  single  digit  corresponding 
to  the  channel  #  (this  is  a  hidden  choice). 


3.1.3  RESET  CHANNELS  (Shf/F6) 

This  function  resets  one  or  multiple  digitizers.  It  only  prompts  for 
single  or  multiple  channels  as  described  in  the  previous  section.  A  short  status 
is  displayed  as  the  operation  proceeds  through  the  selection  list.  If  two  or 
more  channels  specify  the  same  Instniment,  the  reset  operation  will  be  performed 
only  once;  the  status  'skip'  will  be  displayed.  The  possible  status  codes  are: 

Ok  Success 

tmo  Timeout  —  it  usually  means  that  the  instrument  is  offline. 

skip  Operation  already  performed 

Err  ###  Other  error,  an  error  code  follows 

If  '<ESO'  is  pressed  while  the  command  is  executing,  the  operation  will 
be  aborted  before  going  on  with  the  next  channel. 


3.1.4  ARM  CHANNELS  (F6) 

This  function  arms  one  or  multiple  digitizers  for  a  single  sweep  data 
acquisition.  It  assumes  that  the  instrument  is  ready  for  single  sweep  (proper 
horizontal  sweep  speed,  proper  vertical  coupling  and  gain,  proper  trigger,  etc. ) . 
Its  prompt  and  status  reporting  is  similar  to  the  'RESET'  function. 


3.1.5  READ  CHANNELS  (¥7) 

This  ftinction  is  used  after  the  digitizers  have  been  armed  and  have 
recorded  an  event  to  transfer  the  data  into  newly  created  waveforms.  The 
waveforms  are  stored  into  the  arrays  (tokens)  CHI  to  CHS.  The  waveforms  follow 
the  format  described  in  Section  2.2.2,  which  incorporate  data  from  the  digitizers 
and  from  the  setup  (see  next  section).  Its  prompt  and  status  reporting  is 
similar  to  the  'RESET'  function. 


3.1.6  CHANNEL  DEFAULTS  (Shf/F5) 

As  described  in  Section  2.2.2,  a  waveform  stores  the  data  obtained  from  a 
digitizer  along  with  some  information  regarding  the  setup  used.  To  avoid  to  have 
to  fill-in  the  setup  information  for  every  measurement,  a  default  waveform  (like 
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a  tamplata)  la  used  for  each  channel.  This  function  allows  one  to  create,  edit 
and  delete  the  default  waveforms,  one  for  each  channel.  Vftien  editing  a  default 
waveform,  the  waveform  editor  (described  in  Section  3.2.5)  is  called.  Only  the 
following  fields  (highlighted  by  the  editor)  can  be  specified  in  a  default 
waveform:  the  title,  the  label,  the  time  offset,  the  user  offset,  the  cable  type 
and  id. ,  the  sensor  type  and  id. ,  the  sensor  scaling  factor,  the  attenuation,  and 
the  process  list. 

Additionally,  this  function  allows  one  to  save  all  the  default  waveforms 
in  a  file,  and  later  retrieve  them.  The  user  is  prompted  for  a  file  name  and  the 
default  name  'DAQ{DEF>.CHD'  is  used. 


3.1.7  mSCELLANEOnS  FUNCTIONS  (Alt/F6) 

This  function  key  Implements  miscellaneous  functions  particular  to  some 
digitizers.  The  main  prompt  selects  one  of  the  only  two  functions  implemented: 

"Digitize  gnd  ref (clear)  or  defects:  " 

The  'Digitize  ground  reference'  function  is  particular  to  the  TEK7912  and 
DSA602  digitizers.  It  is  used  to  measure  the  zero  Volt  reference  (input 
shorted).  The  'Clear  ground  reference'  function  is  used  to  clear  a  previously 
stored  grotmd  reference.  The  'Digitize  defects'  is  also  particular  to  the 
TEK7912.  It  is  used  to  locate  and  record  the  defects  on  the  internal  graticule. 
It  should  always  be  used  after  the  instrument  has  warmed-up,  and  before  any 
accurate  measurement  are  made. 

The  user  is  then  prompted  for  single  or  multiple  channels.  If  'multiple 
channels'  is  selected,  the  following  prompt  allow  to  further  restrict  the 
operation  to  only  one  type  of  digitizers  if  desired: 

"For  1.  TEK7912,  1.  SCDIOOO,  3.  DSA602  or  all:  " 

The  status  reporting  is  similar  to  the  'RESET'  function. 


3.2  MEASUREMENT  DATA  MANAGEMENT 

This  group  of  functions  implements  a  waveform  data  base  system,  allowing 
one  to  manage  measurement  data  (waveforms)  in  memory  and  on  disk.  It  allows  one 
to  store  the  acquired  waveforms  on  disk  and  to  recall  them  for  plotting  or  for 
further  processing.  It  also  allows  one  to  modify  (edit)  a  waveform 
interactively. 

In  general.  DAQ  offers  several  options  for  the  source  or  destination  when 
manipulating  or  copying  a  waveform.  These  options  may  be: 

channel  Vaveforms  obtained  with  the  'CH.  READ'  function.  They 

are  stored  in  the  variables  (tokens)  CHI  to  CHS. 
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£il« 


User  file.  In  the  fornet  described  in  Section  2.2.4. 

Each  file  nay  contain  up  to  100  waveforms.  It  is  also 
possible  to  create  an  ASCII  file  containing  the  x  &  y 
arrays  of  a  wavefom  in  a  tabular  form. 

workspace  File  used  for  temporary  storage  of  waveforms 

('DAQ{f«KS}.DAT'). 

Stack  From  or  to  the  current  stack.  The  stack  may  also  be  the 

destination  when  the  x  and  y  arrays  of  a  wavefom  are 
extracted. 

For  a  given  operation,  all  the  options  for  the  source  or  the  destination 
nay  not  bo  available.  The  general  prompt  to  specify  a  source  is: 

"from  channel,  stac)^,  £il«  or  tforkspacet  ” 

where  single  digits  1  to  8  can  also  be  used  as  a  shortcut  to  specify  a  channel. 
Similarly,  the  general  prompt  for  a  destination  is: 

"to  staclj,  £11*  or  jrarkspacet  " 

To  avoid  typing  the  file  name  every  time  a  file  is  accessed,  up  to  4  names 
BMiy  be  entered  and  files  are  simply  numbered  1  to  4.  If  *j[ile'  is  selected,  the 
user  is  prompted  for  a  file  number.  If  none  is  specified  (*<CR>'),  the  last 
number  specified  during  a  file  operation  is  used.  Then,  for  both  *£ile'  and 
'jforkspace' ,  the  user  is  prompted  for  an  item  #.  in  the  range  of  1  to  100.  If 
none  is  specified  during  a  write  operation,  the  first  available  (empty)  item  is 
chosen.  The  item  #  must  be  specified  for  read  operations. 

The  teaqplate  below  shows  which  function  keys  are  used  to  implement  the 
waveforms  management  functions: 


CIssrbM 

He 

CM 

snow 

Cti.Mw. 

Wlhl  Mbft 

Oopjry 

Ml 

:  <ilt.  dlMmilll 

Ch.asw 

wimBdi 

SMR 

Sileet 

Oi./km 

Cti.RMd 

CtpyreHMi 

not 

F8 

PB 

FT 

F« 

F9 

F10 

3.2.1  Fill  (Ctl/78) 

This  function  provides  general  file  management.  The  main  prompt  selects 
one  of  the  three  functions  iaq>lemented: 

"liasMi,  £reate  or  list  file:  ” 

The  *Saaie  file'  function  is  used  to  specify  up  to  4  different  file  names 
and  also  to  specify  a  default  file  name  specification.  This  function  can  also 
be  accessed  directly  from  the  main  prompt  with  *d'  to  change  the  default  or  with 
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th«  digits  1  to  4  to  changs  on*  of  th*  nam*s  (th*s«  are  hidden  choices). 
Whenever  a  new  £11*  is  created  or  a  new  name  is  specified,  the  default  '.\*.DAT' 
is  applied,  then  the  default  name  is  used  to  establish  a  default  path,  name  and 
extension. 


Files  must  exist  before  they  can  be  used  as  a  source  or  a  destination.  The 
'Sreat*  file'  function  allows  on*  to  create  a  new  workspace  file  or  a  new  data 
file.  If  a  new  data  file  is  being  created,  th*  user  is  asked  a  file  #  and  file 
name.  Th*  file  name  replaces  the  previous  name.  The  user  can  also  specify  a 
title  idiich  will  be  saved  in  th*  file. 


Th*  '£tisb  file*  function  list  th*  content  of  a  file  on  the  screen  or  in  a 
file.  Th*  user  is  prompted  for  th*  name  of  th*  file  to  list: 


"List  workspace  or  file  £:  " 

where  *#'  is  a  £11*  number  (1-4)  as  described  above.  If  no  file  is  specified 
(*<CR>'),  th*  last  file  nxjmber  specified  during  a  file  operation  is  used.  If 
'£11*'  is  selected,  th*  user  is  prompted  for  a  file  name  (%diich  will  not  be 
stored  for  further  use).  The  user  is  also  prompted  for  the  destination  of  the 
listing: 


"List  to  screen  or  fll*(£on9):  ” 

idler*  th*  default  is  on  screen.  If  th*  listing  is  sent  to  a  file,  its  name  will 
be  the  same  with  the  '.LIS'  extension  in  th*  current  directory.  Each  item 
present  in  the  £11*  is  shown,  with  its  title,  label,  date  of  acquisition, 
channel  #  and  time  step.  A  typical  file  listing  is  shown  here: 


.  .  \DAQ\EXPE1U<IIT .  DAT 

±  _ Sb. 


Neasuresient  of  performance  of  partial  integrator. 
Time  step  Label _ comsient _ 


1  91/08/29  14:34  3 

2  91/08/29  14:40  3 

3  91/08/29  14:47  3 

4  91/08/29  15:21  3 

5  91/08/29  16:03  3 

6  91/08/29  15:58  3 


1.95701-10  Volt. probe  Voltng*  probe 
1.95691-9  Volt. probe  Voltage  probe 
1.95701-10  d-dot  d-dot,  %  Im 

1.95701-10  d-dottPI  Sscop  d-dot,  8  Im,  Part.Int. 
1.95701-10  d-dot-i-PI  Sscop  d-dot,  8  Im,  Part.Int. 
1.95691-9  d-dot-i-PI  8scop  d-dot,  8  Im,  Part.Int. 


where  th*  display  (except  th*  title)  will  scroll.  Not*  that  main  title  and  some 
fields  are  truncated  to  fit  more  information  on  a  single  line.  While  a  file  is 
being  listed,  any  key  can  be  typed  to  suspend  th*  output  to  th*  screen.  '<CR>' 
can  then  be  typed  to  advance  on*  line  at  th*  time,  or  any  other  key  to  resume 
normal  listing.  Th*  '<lSO'  key  can  be  used  at  any  time  to  abort  the  listing. 


If  the  'long'  option  is  chosen,  a  complete  listing  of  every  waveforms  is 
produces,  as  shown  on  Figure  1. 


3.2.2  COPT  WAVlFOIUf  (F8) 

This  function  simply  copies  a  waveform  from  th*  specified  source  (channel, 
stack,  file  or  workspace)  to  th*  specified  destination  (stack,  file  or 
workspace) . 
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Fil«:  Q:\USERS\DAQ\EXPERMNT.DAT 
Titla:  Maasurraent  of  parformanca  of  partial  intagrator 


iHHeilriHritilrilr 


Conant:  d-dot,  @  Im,  Part.Int.  @scopa 
Traca : 

Labal :  d-dot+PZ  @scopa 


Itaa  #:  4 
Ch  #:  3 
Shot  #:  0 


Data:  91/08/29  15:21:24 
Raw  data:  512  pts 


Tlaa  stap:  1.9570E-10 
Tiaa  off sat:  O.OOOOE-1 
Vartlcal  scala:  4.8852E-4 
Vartical  off sat:  -4.0990E2 
Usar  off sat:  2.3000E-2 
Attanuatlon:  3.0000E1  dB 


Scopa:  1000  (TEK  SCDIOOO)  Id:  16089 

Cabla:  0  Id:  0 

Sansor:  0  Id:  11944 

Scala:  2.2599E11 


Procasslng:  Partial  Intagrator  racovary,  (s''t'l)/s,  fc-  3.0000E7 


Flgura  1.  Saapla  of  a  full  listing  of  a  fils. 
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3.2.3  COPY  X&Y  (Shf/FS) 


This  function  extracts  from  a  waveform  the  x  &  y  arrays  and  places  them  on 
the  stack  (two  arrays)  or  in  an  ASCII  file.  The  user  is  asked  if  raw  data 
(default)  or  processed  data  is  desired. 

If  an  ASCII  file  is  specified  for  the  destination,  the  arrays  are  written 
to  it  in  a  tabular  form  (two  columns).  That  file  can  be  used  to  import  the  data 
into  another  program,  such  as  Graftool,  for  advanced  plotting  or  further 
processing.  This  file  format  should  not  be  used  for  general  storage  of  waveforms 
as  all  other  information  stored  in  a  waveform  is  not  copied.  ASCII  files  are 
also  must  slower  to  access. 


3.2.4  COPT  7  (Alt/F8) 

This  function  extracts  from  a  waveform  the  y  array  (raw  or  processed)  and 
places  it  on  the  stack. 


» 


g 
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3.2.5  EDIT  WAVEFORM  (Shf/F7) 

This  function  key  Invokes  the  waveform  editor.  It  can  be  used  to  modify 
any  waveform  j\i8t  acquired  (channels  stored  in  tokens),  on  stack  or  in  files. 
It  is  also  used  to  specify  the  default  waveforms  (see  Section  3.1.6);  the  only 
difference  is  that  default  waveforms  limits  the  editing  to  only  some  of  the 
fields.  Upon  entry,  the  waveform  editor  clears  a  window  of  9  lines;  the  top  6 
lines  are  used  to  display  the  waveform  and  the  two  bottom  lines  are  used  for 
prompts  and  messages.  The  user  is  Initially  prompted  to  select  a  waveform  (from 
channel,  stack,  file  or  workspace): 

"Edit/delete  from  channel,  stack,  £ile,  workspace  or  done:  ” 

If  'delete'  is  chosen,  the  user  is  prompted  again  to  select  a  waveform  to 
delete.  After  a  waveform  has  been  retrieved,  the  display  looks  like; 


Comment :^This  is  a  sample  waveform 
Tr.  Desc:  LI  on  MAIN  Time  step: 

Label:  377  Ohm  Time  offset: 

Date:  91/08/29  16:03:37  User  offset: 
Data:  512  pts  Att.(dB): 

Process:  1  items  Sensor  scale: 


1.9570B-10 

O.OOOOE-1 

2.0033E-2 

3.0000B1 

2.2599B11 


Ch:  4 
Shot :  0 
Sensor : 
Cable: 
Scope: 


V.  scale 
V.  offset 


0  11944 

0  0 
1000  16089 


Kdit/^elete  from  channel,  staclj,  Xile,  iforkspace  or  done: 


Channel  4 


tdtere  a  red  cursor,  shown  next  to  'Comment:'  is  used  to  select  a  particular 
field.  The  arrow  keys  are  used  to  move  the  cursor.  Note  that  the  value  or 
content  of  some  of  the  fields  is  not  shown  (like  the  vertical  scale  and  offset), 
but  they  can  still  be  selected  for  editing.  The  following  keys  perform  specific 
functions: 
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E  or  {Ins} 


Edit  this  field.  The  user  will  be  prompted  for 
additional  input. 

D.  (Del)  or  (BS)  Delete  this  field. 

Ctl/W  Refresh  the  screen. 

{End}  Save  the  waveform  as  modified.  Return  to  the  main 

prompt . 

{ESC}  Discard  all  changes  made  to  this  waveform.  Return 

to  the  main  prompt. 

Some  of  the  fields  of  a  waveform  are  not  usually  set  by  the  user.  If  the 
user  attempts  to  delete  or  modify  one  of  these  fields,  the  prompt  "Are  you 
stire?  "  is  asked  before  proceeding.  The  table  below  sususarlzes  how  every  fields 
are  edited  .  * {P) '  refers  to  protected  fields,  requiring  confirmation  before 

being  modified. 


Comment  ASCII  string.  No  particular  restriction  on  the 

length,  but  it  may  be  truncated  for  display. 


Trace  descr.  (P) 


Label 


Date  (P) 
Data  (P) 


Process 


ASCII  string.  Truncated  to  17  characters  for 
display. 

ASCII  string.  Truncated  to  17  characters  for 
display  and  to  21  for  hardcopy  plots. 

Prompt  to  change:  year,  month,  day,  hour,  minutes 
and  seconds.  *<C3t>'  leaves  the  item  unchanged. 

'{Del}'  will  delete  the  whole  array.  'Edit'  will 
bring  the  additional  prompt.  The  'Remove  defects' 
option  allows  the  removal  of  defects  on  data 
obtained  for  a  TEK7912  digitizers.  This  is  only  an 
estlsMition  of  idiat  the  correct  data  should  be.  The 
'Digitize  defects'  ('Alt/F6')  should  be  used 
instead.  The  'index  array'  option  allows  one  to 
keep  only  a  subarray  of  the  original  by  specifying 
the  first  and  last  indices.  The  'edit  array' 
option  calls  an  array  editor  (described  in 
Section  3.2.7)  that  allows  to  edit  each  element 
individually. 

'{Del}'  will  delete  the  entire  list.  '£dlt'  will 
Invoke  the  process  list  editor  (described  in 
Section  3.2.6). 


Time  step  (P) 

Real 

number. 

Time  offset 

Real 

number. 

Vertical  scale  (P) 

Real 

number. 

Vertical  offset  (P) 

Real 

number. 

Should  never  be  set  to  0. 


A 
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User  offset 


Real  number.  Any  value  can  be  specified  with  the 
*Set'  option,  or  an  estimate  can  be  calculated  from 
the  portion  of  data  prior  the  fast  rising  edge  with 
the  'Compute'  option. 


Sensor  scale 
Channel  #  (P) 

Shot  # 

Sensor  type  &  id. 
Cable  type  &  id. 
Scope  type  &  id.  (P) 

Attenuation 


Real  ntimber.  Ignored  if  0. 

Integer. 

Integer . 

Integers . 

Integers . 

Integers.  Usually  obtained  from  the  GPIB 
configuration. 

Real  number.  In  dB.  Negative  numbers  are 
interpreted  as  a  gain. 


3.2.6  EDIT  PROCESS  LIST 

Vfhen  the  user  requests  to  edit  the  processing  list  (as  part  of  the  waveform 
editor) ,  a  different  editor  is  called.  It  will  initially  display  the  first  6 
processing  items.  A  typical  display  looks  like: 

Offset  by  l.OOOOS-1 
2:  Scale  by  1.2000B1 

0  3 :  Integrate 

4:  Low-pass  filter,  fc«  3.0000E7 
5:  FIR  filter,  file:  cable. fir 

e 

e 

£dit.  Insert,  goggle,  ke3rpad  to  select,  ?  for  help. 

where  each  item  is  sequentially  numbered  and  an  esipty  item  (not  numbered)  marks 
the  end  of  the  list.  A  red  cursor,  shown  next  to  *1:',  is  used  to  select  a 
particular  item.  Up  and  down  arrows,  and  the  page  up  and  page  down  keys  if  there 
are  more  than  six  items,  are  used  to  move  the  cursor.  The  following  keys  perform 
specific  functions: 

(PgUp)  and  (PgDn) 


I  or  (Ins) 


E 


D.  (Del)  or  (BS) 


Display  the  previous  or  next  six  items  in  the  list. 
Use  with  the  up  and  down  arrows  to  select  an  item. 

Create  a  new  item.  The  user  is  prompted  for  the 
type  of  processing  (scale,  offset,  integrate, 
low/hi -pass,  FIR/IIR,  Laplace  transform)  and  for 
parameters . 

Edit  this  item.  The  user  will  be  prosipted  for 
additional  input. 

Delete  this  item. 
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T  or  - 

Toggle  the  enable/disable  flag.  Disabled  items  are 
shown  with  the  flag  *D'  on  the  left. 

Ctl/W 

Refresh  the  screen. 

{End} 

Save  the  process  list  as  modified  into  the 
waveform.  Return  to  the  waveform  editor. 

(ESC) 

Discard  all  changes  made  to  this  waveform.  Return 
to  the  waveform  editor. 

Th«  *Ina«rt'  option  brings  the  additional  prompt: 

”Scale(/),  offset,  IntegrateC-) ,  ItOw/Hl-pass,  FIR/IIR,  L^lace:  " 

vrtiere  the  'Scale',  */'  and  'Offset'  options  multiply,  divide  or  add  a  constant 
to  the  waveform,  the  'Integrate'  and  options  perform  the  Integrate  wavefoirm 
or  integrate  offset  for  end>value  operations,  the  'FIR'  and  'IIR'  options  allow 
specification  of  a  coefficient  file,  the  'Low'  and  'Hi-pass'  options  further 
prosipt  the  user  for  the  parameters  of  a  low-pass  or  hi^-pass  filter,  and  the 
'Laplace'  option  allows  selection  of  one  of  the  special  Laplace  transfer 
functions.  Note  that  some  forms  of  processing  discussed  in  Section  2.2.3  require 
computation  and  storage  of  the  coefficients  (processing  codes  10,  20  and  22). 
These  IteM  will  be  properly  displayed,  but  cannot  be  edited. 


3.2.7  EDIT  RAN  ARRAY 


The  array  editor,  used  by  the  waveform  editor  to  edit  the  raw  data  field, 
displays  the  content  of  an  array  (one  page  at  a  time)  and  allows  the  modification 
any  element  of  the  array.  Upon  entry,  the  display  looks  like: 


1: 

385 

386 

384 

379 

372 

6: 

366 

358 

354 

353 

355 

lit 

359 

364 

368 

373 

378 

16  i 

383 

388 

390 

388 

385 

21: 

381 

376 

373 

369 

364 

Sdit,  ('')PgUp/('')P^n,  {Snd}/{Ksc}. 

where  25  elements  are  displayed  at  once,  the  first  colusufi  showing  the  index  of 
the  first  element  on  that  line.  The  following  keys  perform  specific  functions: 


E  or  (Ins) 
(PgDn) 
(PgUp) 
(End) 


Edit.  The  user  will  be  prompted  for  an  index  and  a 
new  value  for  that  element. 

Display  the  next  25  elements  of  the  array. 
Ctl/{PgDn}  displays  the  end  of  the  array. 

Display  the  previous  25  elements  of  the  array. 
Ctl/{PgUp}  displays  the  beginning  of  the  array. 

Save  the  waveform  as  modified.  Return  to  the  main 
prompt. 
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{ESC} 


Discard  all  changes  made  to  this  waveform.  Return 
to  the  Slain  prompt. 


3.2.8  DEJITTER  WAVEFORM  (Alt/F?) 

The  only  miscellaneous  operation  currently  Implemented  is  a  waveform 
dejitter  function.  This  function  allows  compensation  of  the  trigger  jitter  by 
realigning  one  or  more  waveforms  against  a  reference  waveform.  This  is 
especially  valuable  for  comparing  different  waveforms  or  for  signal  averaging. 
The  dejitter  function  uses  a  least-square  algorithm  to  find  the  best  match 
between  two  arrays.  The  main  prompt  is: 

"De jitter  compute  or  set /reset  reference:  " 


which  is  followed  with  a  prompt  to  specify  a  waveform  if  'compute'  or  'set 
reference'  is  selected.  ^e  'Set  reference'  is  used  to  specify  a  reference 
waveform  (raw  or  processed  array),  along  with  the  option  to  specify  a  N*^^-order 
Butterworth  low-pass  pre-filter.  The  'con^te'  option  computes  the  time  offset 
necessary  to  obtain  the  best  alignment  between  the  two  waveforms.  The  result  is 
stored  back  by  adjusting  the  time  offset  field  of  the  waveform.  The  'Reset 
reference'  option  clears  some  internal  arrays  to  release  some  memory  space. 


3.2.9  MEASURE  WAVEFORM  (Ctl/F7) 

This  utility  simply  returns  some  information  about  the  raw  or  processed 
data  of  a  waveform,  mainly  the  positive  and  negative  peaks,  and  the  rise  time. 


3 . 3  WAVEFORM  PLOTTING 

DAQ  has  the  capability  of  plotting  up  to  20  waveforms  on  a  single  graph. 
It  also  has  the  capability  of  producing  hardcopies  on  a  pen  plotter  (in  color), 
on  a  LaserJet  printer  (monochrome),  or  in  a  file  (HFGL  format).  A  graph  must  be 
produced  on  screen  before  a  hardcopy  can  be  made.  Figure  2  shows  a  typical 
hardcopy  plot.  It  Includes  the  plot  itself  (with  or  without  a  grid),  a  main 
title,  a  label  for  both  axis,  the  date  or  a  range  of  dates  at  which  the 
measurements  were  made,  and  a  list  of  labels  identifying  each  curves.  Graphs 
displayed  on  screen  do  not  show  this  additional  infonsation. 


3.3.1  PLOT  (F9) 

This  key  controls  the  plot  generation.  To  maintain  ASYST  terminology,  it 
has  two  modes:  'Plot'  for  creating  a  new  graph  and  'Data  plot'  for  adding  a 
curve  on  a  graph.  Upon  entry,  the  'Plot'  mode  is  in  effect  and  the  keys  'D'  and 
'P'  are  used  to  change  mode.  The  main  prosipt  is: 

"S/flot,  from  £hannel/stacj(/£ile/workspace,  gefresh/Jiardcopy/zoom:  " 
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iirtiare  adding  a  curve  is  achieved  by  simply  specifying  a  waveform  (from  channel, 
stack,  file  or  workspace).  The  user  is  also  prompted  for  raw  (default)  or 
processed  data.  When  adding  a  new  curve  on  a  graph,  it  is  clipped  to  fit  the 
current  borders.  The  'refresh'  option  is  used  to  redraw  the  graph,  with  all 
curves  fitting  completely  within  its  borders  (unless  the  zoom  feature  is  active). 
The  'zoom'  option  allows  one  to  skip  the  autoscale  feature  and  let  the  user 
specify  a  range  for  both  X  and  Y  axis.  If  only  one  value  is  given  for  range, 
then  a  lower  bound  of  0  is  taken.  The  'hardcopy'  option  produces  a  hardcopy  of 
the  last  plot.  '<CR>'  is  use  to  exit  to  the  ASYST  prompt. 


3.3.2  PLOTTER  (Shf/F9) 

This  key  is  used  to  specify  the  destination  of  the  hardcopy  plots,  the 
niimber  of  pens  to  use,  and  the  title  and  labels  to  include  in  the  hardcopy.  The 
main  prompt  is: 

"Plotter  destination,  #  of  pens,  gabels:  " 
and  the  prompt  to  specify  the  destination  is: 

"Send  plot  to  OOMl,  LPTl,  spool,  file  or  none:  " 

If  COMl  or  LPTl  is  specified,  it  is  assume  that  the  device  will  correctly 
Interpret  HPGL  comisands.  If  the  device  is  a  HP  LaserJet,  it  must  be  switched  to 
HPGL  Emulation  mode  before  any  commands  are  sent.  If  'spool'  is  specified,  a 
temporary  file  will  be  created  and  sent  to  the  device  with  the  DOS  PRINT  command. 
This  effectively  sends  the  data  in  background  and  improves  the  interactive 
response  of  the  computer.  The  'gpool'  option  however  does  not  work  very  well 
with  DESQvlew.  It  may  be  necessary  to  redirect  the  output  of  the  PRINT  command. 
Consult  the  DOS  nuinual  for  additional  information  on  the  PRINT  command.  If 
'file'  is  specified,  the  user  is  prompted  for  a  file  name.  If  the  name  contains 
an  extension,  a  single  file  will  be  created  for  all  the  plots  (separated  with  a 
'new  page'  comsiand) .  If  the  name  does  not  have  an  extension,  a  new  file  will  be 
created  for  every  plot,  with  an  extension  ###,  which  is  a  sequential  number  from 
001  to  999. 

The  '#  of  pens'  option  defines  the  number  of  colors  to  use.  By  convention, 
pen  #1  is  always  black  and  is  used  to  draw  the  box,  axis  and  text;  pen  #2  is 
always  yellow  and  is  used  to  draw  the  grid  only.  Other  pens  will  be  used  to  draw 
the  curves.  For  LaserJet  outputs,  the  number  of  pens  should  be  1  if  the  grid  is 
not  desired,  or  2  if  it  is  desire.  If  only  1  or  2  pens  are  used,  DAQ  will 
automatically  label  each  curve  with  a  different  symbol,  as  shown  on  Figure  2. 

The  '^abel'  option  is  used  to  specify  a  main  title  and  the  x-axis  and 
y-axis  labels  to  be  Included  in  hardcopies.  If  the  x-axis  label  is  not 
specified,  "Time  (s)"  will  be  used  (the  unit  in  parentheses  will  automatically 
be  adjusted  to  reflect  the  range  of  x-values). 
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4.0  PROGRAMMIMG  WITH  DAO 


To  date,  the  DAQ  software  contains  more  than  10000  lines  of  code,  in  about 
80  files  found  in  the  '\USERS\DAQ'  and  *\USERS\LIBRARy'  directories.  This 
chapter,  which  is  definitely  not  an  exhaustive  review  of  all  the  programs, 
describes  the  more  important  and  useful  programs  to  complement  the  interactive 
functions  described  in  the  previous  chapter  with  the  capability  of  writing  user- 
written  programs.  The  source  files  are  well  documented  and  more  information  can 
be  found  there.  The  S3mtaz  of  the  various  programs  given  herein  is  in  the  format 
used  in  the  ASYST  docijmentation. 

Some  of  the  programs  defined  in  this  chapter  are  precompiled  and  stored  as 
application  overlays  ('*.AOV'  files).  Before  these  programs  can  be  called,  it 
is  necessary  to  load  the  overlay,  which  is  done  by  inserting  this  line  within  the 
program  definition: 

[ USE . AOV . PATH ]  [ COMPILE ]  [ USE . AOV. PATH ] 

Similarly,  this  line  allows  the  use  of  an  ASYST  overlay  which  is  not 
permanently  loaded: 

[USE. SOV. PATH]  [COMPILE]  [USE. SOV. PATH] 

It  should  be  noted  that  only  one  transient  overlay  can  be  loaded  at  a  given 
time;  the  previous  one  is  automatically  tinloaded. 


4.1  ERROR  PROCESSING 

Error  recovery  in  ASYST  is  achieved  with  the  use  of  a  'ONERR: '  clause  at 
the  end  of  a  program  definition.  When  an  error  occurs,  the  program  is  aborted 
and  the  code  following  the  'ONERR:'  clause  is  executed.  The  program  may  test  for 
error  code  and  decide  to  handle  the  error  or  to  propagate  it  to  the  caller  (which 
gets  an  error  interrupt).  Many  programs  described  in  this  chapter  will  perform 
general  checks  on  arguments  and  attempt  to  recover  from  some  expected  error 
conditions.  In  those  cases,  the  caller  will  be  warned  of  an  error  by  some  means 
(flag,  specific  value  returned,  etc.),  and  the  '7ERROR#'  flag  and  '7ERROR"' 
string  can  be  used  to  determine  the  exact  cause  of  the  error.  Unexpected  errors 
are  generally  simply  propagated  and  will  probably  result  in  the  main  program 
being  aborted. 


4.2  STRUCTURES 

Structure  allows  one  to  store  together  multiple  objects  of  different  type 
and  size.  Because  structures  vary  in  size,  they  must  be  stored  into  tokens.  The 
'TOKEN'  consuind  defines  the  tokens,  *EXP.MEM>'  allocates  them  in  expanded  memory, 
and  'BECX3KES>'  and  'EQUXV>'  assign  an  array  to  them. 

All  ftinctions  related  to  structures  are  found  in  'STRUCTUR.ASY' .  All 
recoverable  errors  are  given  an  error  number  in  the  range  900-905  and  a  text 
describing  the  error  is  stored  in  '7ERROR”'.  All  errors  are  propagated. 
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The  syntax  and  a  short  description  of  the  main  functions  is  shown  below. 
Arguments  may  be:  'str'  a  structure  (integer  array),  'item#'  the  item  in  the 

structure  to  operate  on,  'scalar',  'array'  or  'string'  the  content  of  an  item, 

or  't/f'  a  true/false  flag. 

OCREATE  [  n  —  str  ]  To  create  a  structure  with  'n' 

items.  Initially  empty. 

ODELETB  [  str  item#  —  str  ]  To  delete  the  content  of  an  item. 

{}SIZE  [  str  item#  —  str  size  ]  Return  the  size  of  item  (#  of 

elements  in  array  or  characters  in 
string),  or  0  if  empty. 

The  following  functions  extract  the  content  of  an  item  as  a  scalar,  an 

array  or  a  string  respectively.  An  error  is  returned  if  the  request  is 

inconsistent  with  the  data  stored. 

OREAD  [  str  item#  —  scalar  ] 

{ }READ [ ]  [  str  item#  —  array  ] 

OREAD"  (  str  Item#  —  ]  (  —  string  ) 

but  if  the  item  is  empty,  a  scalar  '0'  or  a  null  string  is  returned. 
Additionally,  the  functions  'OREAD?'  and  '{}READ[]7'  are  similar  except  that 
they  also  return  a  logical  flag:  true  if  there  is  data  stored,  and  false  if  item 
empty,  in  which  case,  nothing  is  returned  on  stack. 

The  following  functions  store  a  scalar,  an  array  or  a  string  into  a 
structure : 

OSTORE  [  str  scalar  item#  —  str  ] 

OSTORE[]  [  str  array  item#  —  str  ] 

OSTORE"  [  str  item#  —  str  ]  (  string  —  str  ) 

4.3  WAVEFORMS 

Several  functions  can  be  found  in  'ffFM.ASY'  which  manipulate  waveforms. 
It  is  also  possible  to  manipulate  waveforms  directly  with  the  ftmctions  defined 
in  the  previous  section  and  referring  to  Section  2.2.2  for  the  internal  format 
of  a  waveform.  In  that  case,  direct  manipulation  should  all  be  done  or  defined 
in  few  files,  in  case  the  definition  of  a  waveform  is  altered  later. 

All  recoverable  errors  are  in  the  range  910-913  with  a  text  stored  in 
'TERROR"'  describing  the  error.  Recoverable  errors  are  not  propagated;  it  is 
up  to  the  caller  to  check  if  an  error  has  occurred  by  testing  'TERROR#'. 

The  syntax  of  these  functions  is  shown  below,  where  'wfm'  represent  a 
waveform: 
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WFN. CREATE  [  —  wfm  ]  Create  an  empty  waveform. 

WFM[WF]  [  wfm  —  array  ]  Extract  the  raw  data  array  from  the 

waveform.  It  is  only  affected  with  the 
vertical  gain  and  offset.  Scalar  *0'  is 
retumed'if  no  data  present. 

HFM(H7P]  [  wfm  —  eurray  ]  Extract  the  processed  data  array,  or 

scalar  *0'  if  no  data  present. 

WFMIX. ARRAY]  [  wfm  y-arr  —  x-arr  y-arr  ] 

Extract  the  corresponding  time  array.  The 
raw  or  processed  data  array  must  be 
obtained  first. 

Set  the  raw  data  flag. 

Set  the  processed  data  flag. 

Extract  the  raw  or  processed  data  array, 
according  to  flag. 

In  addition,  several  utilities  are  defined  in  'W7M.PGM'  that  perform 
operations  directly  on  the  raw  or  processed  data  arrays  of  waveforms  as  selected 
by  'RAW'  and  'PROCESSED'.  The  three  basic  types  of  operations  are;  a  monadic 
operation  on  a  data  array,  a  diadlc  operation  between  a  data  array  and  a  scalar, 
and  a  diadic  operation  between  two  data  arrays.  In  the  later  case,  the  time 
offset  is  used  to  align  both  data  arrays  and  only  the  overlapping  portions  are 
kept,  resulting  in  two  arrays  of  same  size.  Therefore,  it  is  very  important  to 
align  both  waveforms  (see  Section  4.5)  before  'HFN.OP2'  is  called.  In  the 
descriptions  below,  'fen'  refers  to  an  ASYST  word  or  a  user-defined  function. 
When  operating  on  arrays,  all  arrays  will  have  the  same  size. 

WFM. ENTER  [  wfm  —  new-wfm  ]  Must  be  called  to  put  the  first 

waveform  on  stack  and  prepare  the 
result . 

INSTALL  fen  WFM.OPl  (  wfm  —  wfm  ] 

Perform  a  monadic  operation  on  the 
data  array  of  a  waveform.  The 
syntax  for  'fen'  is: 

fen  [  array  —  newarray  ] 

INSTALL  fen  WFM.OPl  [  wfm  scalar  —  wfm  ] 

Perform  a  diadic  operation  on  the 
data  array  of  a  waveform  and  a 
scalar.  The  syntax  for  'fen'  is: 
fen  [  scalar  array  —  newarray  ] 

INSTALL  fen  WFM.OP2  [  wfml  wfm2  —  wfm  ] 

Perform  a  diadic  operation  between 
the  data  arrays  of  two  waveforms. 

The  syntax  for  'fen'  is: 

fen  [  arrl  arr2  —  new-arr  ] 


RAW  (  —  ] 

PROCESSED  [  —  ] 

WFM[WFM]  [  wfm  —  array  ] 


WFM.CNT-i"«-  [  wfm  —  wfm  ]  Use  the  waveform  scale  factor  field 

to  implement  a  counter  C  (storing 
l/C) .  This  function  increment  C. 

WFM.AV6.lst  [  wfm  —  avg-wfm  ]  Start  averaging. 

WFM.AV6  [  avg-wfm  wfm  —  avg-wfm  ]  Add  one  more  waveform  to  the  average. 

Here  are  few  examples  to  illustrate  how  to  properly  used  these  functions. 
The  first  one  shows  how  to  negate  a  waveform: 

wfml  RAW  WFM. ENTER  INSTALL  NEC  WFM.OPl 

while  this  example  shows  how  to  add  an  offset  to  a  waveform: 

wfml  RAW  WFM. ENTER  1.2  INSTALL  WFM.OPl 

and  this  last  one  shows  how  to  subtract  two  waveforms  (such  as  two  samples 
obtained  from  differential  channels  or  to  compute  an  error  term) : 

wfml  RAW  WFM. ENTER  wfm2  INSTALL  -  WFM.OP2 


4.4  FILES 

The  functions  defined  in  file  'DAQ-FILE.ASY'  allow  one  to  store  and  recall 
waveforms  as  with  the  interactive  function  keys,  ie.  by  specifying  a  file  number. 
In  addition,  some  more  general  functions  are  defined  in  file  'DAQ-VARR.ASY'  to 
allow  one  to  store  or  recall  waveforms  or  any  integer  arrays  in  files  specified 
by  name.  All  these  functions  are  not  loaded  permanently,  but  are  precompiled 
into  the  'DAQ-FILE.AOV'  overlay.  This  overlay  must  be  loaded  as  described  at  the 
beginning  of  this  chapter  before  these  fvmctions  can  be  used. 

All  recoverable  errors  are  in  the  range  930-934,  including  recoverable  file 
I/O  errors  (such  as  file  not  found,  etc.).  A  short  text  is  also  stored  in 
*  TERROR”'.  Recoverable  errors  are  not  propagated;  it  is  up  to  the  caller  to 
check  if  an  error  has  occurred  by  testing  'TERROR#'. 

The  following  two  functions  store  or  recall  waveforms  from  files,  'item#' 
is  a  waveform  index,  'file#'  is  as  defined  with  the  'Ctl/F8'  function  key,  and 
'wfm'  is  a  waveform: 

DF. RECALL  [  item#  file#  —  wfm  ] 

DF. STORE  [  wfm  item#  file#  —  ] 

but  if  the  item  is  empty,  'DF. RECALL'  will  return  the  scalar  *0' . 

The  following  functions  allow  one  to  open  a  file,  read  or  write  to  it,  and 
close  it.  Only  single  precision  Integer  arrays  (and  hence  waveforms)  of  any 
length  can  be  stored.  'filnam'  specifies  the  file.  'FILE. CLOSE'  is  used  to 
close  a  file. 

VA. CREATE  [  —  ]  (  filnam  —  )  Create  a  new  empty  data  file. 
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VA.OPEN 


]  (  filnam  —  ) 


(  - 


Opan  a  data  file. 


VA. STORE  [  array  item#  —  ] 


Store  the  integer  array  into  file. 


VA. RECALL  [  item#  —  array  ]  Recall  an  array  from  the  file. 

Nothing  is  returned  if  an  error 
occura;  'TERROR#'  should  be 
checked. 


4.S  WAVEFORM  DEJITTER 

Three  functions  defined  in  file  'DAQ-DJIT.ASY'  implement  the  waveform 
dejitter  operation  described  in  Section  3.2.8.  An  index  offset  is  calculated 
using  a  least-square  algorithm  to  obtain  the  best  match  between  the  data  arrays 
of  two  waveforms.  This  index  offset  is  converted  to  time  offset  and  stored  in 
the  time  offset  field  of  the  waveform.  The  'RAW'  and  'PROCESSED'  functions  are 
use  to  select  the  proper  data  for  subsequent  operations .  Note  that  these 
functions  release  any  transient  overlay  loaded. 

DEJITTER.REF  [  wfm  —  wfm  ]  Store  the  reference  array  (raw  or 

processed  data) . 

REAL  VECTOR!  N  ,  ]  DE JITTER . FILTER  :« 

Store  the  pre-filter  specification. 
Cleared  by  'DE JITTER. CLEAR' . 

DE JITTER. CLEAR  (  —  1  Clear  the  reference  array  and 

release  the  memory. 

DEJITTER. WFM  [  wfm  —  wfm  ]  Align  the  raw  or  processed  data  of 

the  waveform  against  the  reference. 

The  example  below  illustrates  the  use  of  the  dejitter  function  for  the 
averaging  of  two  waveforms  (note  that  'WFM.AVG.lst'  and  'WFM.AVG'  could  have  been 
used  instead) : 

wfml  RAW  DEJITTER.REF  WFM. ENTER 

wfm2  DEJITTER. WFM  INSTALL  WFM.OP2  0.5  INSTALL  *  WFM.OPl 


4.6  DIGITAL  FILTERS 

As  shown  before,  waveform  may  include  a  data  processing  list,  idilch  may 
include  digital  filters.  The  two  types  of  filters  considered  here  are  the 
'finitm  iapulse  rmuponsm'  (FIR)  and  'infiaitm  LmpalM*  rmsponsm*  (HR)  filters. 
They  are  derived  from  the  z-transform  theory  and  discrete  (or  sampled)  systems 
theory  ((1],  [2],  [3]). 

The  FIR  filter  Involves  the  multiplication  of  the  previous  values  of  the 
input  sequence  '{x}'  with  some  coefficient  to  obtain  the  resulting  sequence 
'{y}'.  The  resulting  algorithm  is  non-recursive.  The  z-transform  and  the 
corresponding  non-recursive  equation  is  shown  here: 


and 


H(z)  -  bo  ♦  ♦  b,-*"*  ♦  ...  *h^-z 


/n  ♦  b2**n-2  ♦  •  •  •  *  V*n-« 


Tha  HR  Involvaa  tha  oniltlplicatlon  of  both  tha  input  and  output  saq  ances 
with  soaa  coafficiants  to  obtain  tha  rasult.  Tha  rasulting  algoriwtjt  is 
racursiva:  pravious  valuas  of  tha  output  saquanca  ara  also  usad.  Tha  z- 

transform  and  tha  eorrasponding  racursiva  aquation  is  sho%m  hara: 

H(.,  .  b,  ...  .y,-- 

Sq  ♦  ai‘  z  ■*■  +  a2‘  z  ♦  ...  ♦  a|j*  z  '*■ 


and 


yn  “  (  bo**n  ♦  V*n-1  ♦  V  *n-2  *  •  •  •  *  V  «n-  •  • 


•  •  ■  -ai*yn-l  -  ^I'Vn-Z  -  .  .  .  -  ak*yn-k  )  /“o 


Tha  raalization  of  an  IIR  filtar  from  tha  aquations  abova  often  rasults  in 
significant  arrors  dua  to  ntimarical  round-off  for  hi^ar  ordar  filtars.  Thasa 
arrors  can  ba  avoidad  by  raalizing  tha  filtar  in  a  cascada  form.  ia.  H(z)  is 
dafinad  as  tha  product  of  small  ordar  filtars: 


H(z) 


.  bpo  ♦  bp^z-^  ♦  boaZ-» 
*00  *  *01*  *  *02*  * 


bio  ♦  ♦  bi2Z-»  . 

*10  ♦  *11*  ♦  *12*'* 


In  ganaral,  tha  filtar  coafficiants  '{•>’  and  '{b}'  ara  computad  for  a 
givan  At.  Computing  thasa  coafficiants  is  not  aasy  and  oftan  tima  consuming. 
Many  tachnlquas  ara  availabla  for  computing  tha  propar  coafficiants,  such  as  tha 
impulsa  invarlanca,  tha  blllnaar  transformation,  tha  impulsa  rasponsa  windowing, 
and  tha  fraquancy- sampling.  It  is  possibla  to  stora  multipla  sats  of  pra- 
computad  coafficiants  in  a  flla  and  spacify  only  tha  fila  nama  for  furthar  accass 
(saa  Sactlon  3.2.6).  Each  sat  corraspond  to  a  givan  At:  thus  tha  fila  can  ba 
saan  as  a  lookup  tabla  of  coafficiants. 

Tha  following  functions,  found  in  fila  *  PROCESS. ASY ' ,  ara  usad  to  build 
filas  containing  FIR  or  IIR  filtar  coafficiants.  Tha  programs  attampts  to 
racovar  soma  arrors,  but  all  arrors  ara  propagatad. 

Thasa  two  functions  craata  a  naw  ampty  fila  for  FIR  or  IIR  filtars 
raspactivaly: 

CRIXTB. FIR. FILE  [  —  ]  (  filanama  —  ) 

CREATE. IIR. FILE  [  —  ]  (  filanama  —  ) 
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whil*  th«  n«xt  thre*  functions  ars  usad  to  store  the  pre-conputed  coefficients 
('{a}',  *{b}'  and  *{a&b}')  of  FIR,  IIR  and  cascaded  HR  filters  respectively  into 
these  files: 

FIR>F1LE  [  {b}  AT  —  ]  (  filename  —  ) 

XIR>F1LE  [  {a>  {b>  AT  —  ]  (  filename  —  ) 

IIR>FI];.E  [  {aftb}  AT  —  ]  (  filename  —  ) 

where  *  {a} '  and  '  {b} '  are  real  vectors  idiere  the  Sq  and  bg  are  stored  last :  and 
'{aftb}'  is  a  real  matrix  of  dimension  Nx6,  trhere  each  line  stores  the 
coefficients  of  one  cascade  stage  :  [  b2  b^  bg  a2  a^  ag  ] . 


4.7  INSTRUMENTATION  CONTROL 

Several  f\inctlons  are  defined  in  *  SCOPE. XSY'  which  provide  a  standard 
procedure  to  Interface  with  the  various  digitizers.  They  act  as  the  main 
dispatcher  to  device  specific  routines.  These  functions  are  not  permanently 
loaded,  but  are  precompiled  into  the  ' SCOPS. AOV'  overlay,  %rtiich  must  be  loaded 
first. 


All  recoverable  errors  are  in  the  range  920-929  or  496-543  (GPIB  errors). 
Recoverable  errors  are  not  propagated;  it  is  up  to  the  caller  to  check  if  an 
error  has  occurred. 

All  these  functions  operation  on  a  single  instrument.  This  function 
selects  a  particular  digitizer  (specifying  its  channel  #) ,  and  must  be  called 
first: 


SCOPE. SELECT  [  ch#  —  ] 

These  three  functions  implement  those  accessed  through  the  function  keys 
'Shf/F6'.  'F6'  and  'F7'  respectively: 

SCOPE. RESET  [  —  ] 

SCOPE. ARM  (  —  ] 

SCOPE. READ. WFN  (  df.wfm  —  wfm  ] 

where  'df.wfm*  is  the  default  waveform,  or  an  empty  waveform  (create  with 
' WFM. CREATE' )  .  To  retrieve  a  default  waveform  entered  with  the  'Shf/F5*  key,  use 
the  following  lines: 

CH.DEF  CH#  {}READ[]? 

NOT  IF  WFM. CREATE  THEN 


4.8  PLOTTING  GRAPHICS 

Several  functions  are  defined  in  the  files  *  PLOT. LIB ' .  ’ PLOTTER. UTL*  and 
'COLORS. UTL'  to  extend  the  plotting  capabilities  and  provide  hardcopy  support  to 
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various  destinations.  All  these  functions  are  also  available  by  loading  the 
’PLOT.AOV'  overlay. 

The  functions  ’X.PLOT*.  ’XY.PLOT',  ’X.DPLOT' .  'XY.DPLOT'  are  defined  to  be 
used  in  place  of  ’X.AUTO.PLOT' ,  'XY.AUTO.PLOT' ,  ‘X. DATA. PLOT' ,  ’ XY . DATA . PLOT ' 
^  respectively.  They  generate  nicer  plots  and  can  be  used  to  draw  on  screen  or  on 

hardcopy . 

»  The  functions  defined  in  'CC'ORS.UTL'  are  used  to  maintain  two  palettes  of 

colors  for  the  screen  and  the  hardcopy  (plotter) ,  selected  with 
'USE. SCREEN. COLORS'  and  'USE. PLOTTER. COLORS'  respectively.  The  variable  '#PENS' 
is  set  with  the  nvimber  of  pens  (ie.  colors)  to  use,  and  the  functions 
'1ST. COLOR',  'NEXT. COLOR'  and  'SET. COLOR  [  n  —  ]'  are  used  in  place  of  'COLOR' 
to  select  a  color  for  a  curve.  Previous  colors  will  be  reuse  if  needed. 

The  functions  defined  in  ' PLOTTER. UTL'  are  used  to  redirect  the  plots  to 
a  hardcopy  device  or  to  a  file  (plots  will  therefore  be  suppressed  on  screen). 

-PLOTTER. PORT  [  —  ]  (  dest  -  ) 

Specify  the  destination  of  hardcopy  plots. 
Valid  destinations  are:  '-NULL'  to 
disable  plotter,  'COMl:'  or  'LPTl:'  for 
serial  or  parallel  port,  'PRN:'  for  the 
DOS  spooler  ('PRINT'  command),  'filename' 
to  send  to  files  *.001,  *.002,  etc.,  or 
'filename. ext'  to  accumulate  all  plots  in 
•  a  single  file. 

PLOT>PLOTTER  Redirect  all  future  plots  to  the  hardcopy 

,  device.  Usually  used  in  conjunction  with 

' USE . PLOTTER . COLORS ' . 

PLOT>PLOTTER.STOP  Resume  plots  to  the  screen.  Usually  used 

in  conjunction  with  ' USE. SCREEN. COLORS ' . 

PLOTTER. PAGE  Force  a  new  page  or  a  new  file. 

CHAR.%SIZE  [  %h  %v  ]  Specify  character  size,  both  horizontally 

and  vertically.  Default*!. 
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